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5.0 Reference 

This section describes the actual OLE Interfaces exposed, the definitions of the data structures 
used when passing data around, and the definitions of each class used internally by the XMC 
Driver Administrator Component. 



5.1 Interfaces 



Other than the standard OLE interfaces IUnknown, IClassFactory, and IDispatch, there is one 
other standard OLE interface, and two custom OLE interfaces specific to the XMC Driver 
Administrator Component. These interfaces are the IXMCJEnumDriver, IXMCJ)riverAdrnin, 

and IXMC DriverAdrninDebug interfaces. 

/Unknown 



CDriverAdministratorObject 



T 



IClassFactory C — 
IDispatch Q 




I XMC_Enum Driver Qy- 



IXMC^DriverAdmin cy 



IXMC_DriverAdminDebug ,~— 



Specific Standard Inurftu 



( Standard lEnumX OLE Z 0 Interface 




I Register 
■ UnRegister 
\ Setup 



Enable 
EnumDriver 
En urn Interlace Support 
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/ EnaDteLogging EnabteDlegnosticTesting 
SetLoggtngStream IsOiagnosticTestingOn 
IsLoggtngOn 
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Figure 11 Interface-Map. 

For more information on the standard OLE interfaces see the OLE 2 Programmer 's Reference. 
And, for more information on the custom. XMCAPI interfaces, see thtXMCAPI Reference. 

5.2 Exported Functions 

The following are the functions exported by the driver DLL. 



XMC_DRIVERADMIN_MODULETYPE 

LPCLSID 

300L 

3COL 



DLLGetModuleType ( void ); 
DLLGetCLSID ( void ); 
DLLRegiscerServer ( void ); 
DLLUnRegisterServer ( void ); 



5.3 Structures and Defines 

This section defines all structures, enumerations, and defines used by the driver. 

5.3.1 XMC_DRIVERADMIN_MODULETYPE Enumeration 

The following enumeration is used to mark the module type of the component. 

enum XMC_DRIVERADMIN_MODULETYPE 

( 

XMC_DRIVERADMIN MT - 0x6000 

); 
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53.2 XMCJLOGGINGTYPE Enumeration 

The following enumeration describes the different types of logging supported by the XMC Driver 
Administrator Component. 

enum XMC LOGGINGTYPE 
{ 

XMC_LT_API, 
XMC LT_CMD, 
XMC~LT BIT 

}; 

5.3-3 XMCJ)RIVERJNFO Structure 

The following structure is used when setting up and querying the state of the driver. 

Struct XMC_DRIVER_INFO 

{ m_hDriver; 

m_mt ; 

m_bS t r e amMgmt Lo c ke d ; 
m_ps zHa rdwa r eVendo r ; 
m_cbMaxHardwareVendor ; 
m_pszHardwareModel ; 
m_cbMaxHardwareModei ; 
m_pszDriverVendor; 
nTcbMaxDr i verVendo r ; 

); 



XMC HDRIVER 


[in, out] 


XMC DRIVER MODULETYPE 


[out] 


BOOL 


[out] 


LPTSTR 


[out] 


DWORD 


[in] 


LPTSTR 


[out] 


DWORD 


[in] 


LPTSTR 


[out] 


DWORD 


[in] 



53.4 XMC_STREAMJNFO Structure 

This structure is used to pass all stream specific data used to both setup the stream, and query the 
stream for its current settings. 



struct XMC_STREAM_INFO 
< 

XMC_H STREAM 

XMC STREAM MODULETYPE 



mJiStream; 
irTmt ; 



union { 



1; 



In- 



struct PCBus 



DWORD dwPort; 
DWORD dwIRQ; 



truct Serial 



DWORD dwPort; 
DWORD dwBPS; 



truct TextFile 

LPCTSTR pszFileName; 

truct. Custom 

DWORD dwParaml; 
DWORD dwParam2; 
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5.4 Class s 

This section contains the definition of all classes used by the XMC Driver Administrator 
Component in its implementation. 

5.4.1 CDriverAdminDisp Class 

The CDriverAdminDisp class acts as the dispatch, or control, object used to separate all OLE 
details from the code implementing the driver internals. This object coordinates all operations 
taking place in the driver by directing other C++ object to carry out the work of the operation. The 
following is the definition of the CDriverAdminDisp class. 

class CDriverAdminDisp 
{ 

public: 

// Constructors & Destructors 

CDriverAdminDisp ( void ); 
-CDriverAdminDisp ( void ) ; 

// Initialization 

DWORD Initialize ( void ) ; — 



//- iXMC_EnumDriver Helper Methods - 

DWORD GetFirstDriverCLSID( LPCLSID pDrvCLSID ); 
DWROD GetNextDriverCLSID{ LPCLSID pDrvCLSID ); 
DWORD GetFirstDriver( LPUN KNOWN *ppDriverUnk ); 
DWORD GetNextDriver ( LPUNKOWN *ppDriverUnk ) ; 



// iXMc_EnumInterfaceSupport Helper Methods 

DWORD GetFirstlnterf aceSupport ( LPDRVIFSUPPORT pDIFS ) ; 
DWORD GetNexjtDriverlnterf aceSupport ( LPDRVIFSUPPORT pDIFS ), 

// I XMC_D river Admin Methods 

DWORD GetDriverlnfoMapf LPXMCDRIVERINFOMAP pDIMap ); 
DWORD Register ( XMC_H DRIVER hDrv, XMC_HSTREAM hStrm, 

LPCTSTR ps zModuleName ) ; 
DWORD UnRegister( XMC_HDRIVER hDrv, XMC_HSTREAM hStrm ); 
DWORD Setup ( XMC_H DRIVER hDrv, XMC_HSTREAM hStrm, 

LPVOID plnf o ) ; 
DWORD Enable ( XMC_H DRIVER hDrv, XMC_HS TRE AM hStrm ); 



//- iXMC_DriverAdminDebug Methods 

DWORD EnableLogging ( XMC LOGGINGTYPE It, BOOL bEnable ); 
DWORD SetLoggingStream< XMC_LOGGINGTYPE It, 

LPXMCSTREAM pStrm ) ; 
BOOL IsLoggingOn( XMC_LOGGINGTYPE It ); 
DWORD EnableDiagnosticTesting ( BOOL bEnable ); 
BOOL IsDiagnosticTestingOn( void ); 



private : 

// Privat Data 

CModuleMgr m moduleMgr; 

}; 
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5.4.2 CModuleMgr Class 

The CModuleMgr is responsible for managing all drivers and streams registered in the system. 
For example, stream and driver registration is controlled by the CModuleMgr class. A list of all 
drivers registered with the CModuleMgr is stored in the registration database. Stream registration 
is passed through to the corresponding driver. The CModuleMgr class is defined as follows. 

class CModuleMgr 
{ 

public: 

// Constructors & Destructors 

CModuleMgr ( void ) ; 
-CModuleMgr ( void ) ; 



// Initialization 

DWORD Initialize ( void ); 



// Driver Actions 

DWORD RegisterDriver ( XMC_HDRIVER hDriver ); 

DWORD UnRegisterDriver ( XMC_HDRIVER hDriver ); 

DWORD SetDriverInfo( XMC_HDRIVER hDrv, LPXMCDRIVERINFO pDI 

) . 

DWORD GetDriverInfo( XMC_HDRIVER hDrv, LPXMCDRIVERINFO pDI 

) ; 

// Stream Actions 

DWROD RegisterStream( XMC_HSTREAM hStream ); 

DWORD UnRegisterStream( XMC HSTREAM hStream ); 

DWORD SetStreamInfo( XMC HSTREAM hStrm, LPXMCSTREAMINFO pSI ); 

DWORD GetStreamInfo{ XMC~HSTREAM hStrm, LPXMCSTREAMINFO pSI ); 



// General Actions 

DWORD GetFirstlnterfaceSupport ( LPDRVIFSUPPORT pDIFS ); 

DWORD GetNextDriverlnterf aceSupport ( LPDRVIFSUPPORT pDIFS ); 

DWORD GetFirstDriverCLSID( LPCLSID pDriverCLSID ); 

DWORD GetNextDriverCLSID( LPCLSID pDriverCLSID ); 

DWORD GetFirstDriver ( LPUNKNOWN *ppDriverUnk ); 

DWORD GetNextDriver ( LPUNKNOWN -ppDriverUnk ); 

DWORD LoadDriverlnfoMap ( LPDRIVERINFOMAP pDrvInfoMap ) ; 

private: 

// Private Data 

CSimpleDriver m rgDriversf]; 

DWORD nTcbDrivers; 

); 

5.43 CSimpleDriver Class 

The CSimpleDriver class is used to communicate directly with the driver component. All OLE 
related details are encapsulated within this class. 

Class CSimpleDriver 
( 

public: 

// Constructors & Destructors 



CSimpleDriver ( void ); 
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-CSimpleDriver ( void ); 

// Initialization 

DWORD Initialize (. CLSIDfi rDriverCLSID ); 
DWORD Attach ( CLSIDfi rDriverCLSID ) ; 
DWORD Detach ( void ); 



// Actions 

DWORD SetDriverlnf o ( LPXMCDRIVERINFO pDI ) ; 
DWORD GetDriverInfo( LPXMCDRIVERINFO pDI ); 

DWORD GetStreamList ( LPS IMPLE STREAM rgStrms, LPDWORD pdwCount ); 
DWORD GetCLSID ( LPCLSID pDriverCLSID ); 
DWORD GetHandle ( LPXMC_HDRIVER phDriver ) ; 

private: 

// Private Data 

LPXMCDRVCORESTAT I CSTATE m_pDrvCoreStaticState ; 

LPXMCDRVCOREDYNAMICSTATE m_pDrvCo re Dynamics tate; 

LPXMCDRVEXTSTREAMMGMT ra_pDrvExtStreamMgmt ; 



5.4.4 CSimpleStream Class 

The CSimpleStream class is used to communicate directly with the stream component. All OLE 
related details are encapsulated within this class. 

class CSimpleStream 
{ 

public: >. 
// Constructors & Destructors 

CSimpleStream ( void ); 
-CSimpleStream ( void ); 

// Initialization 

DWORD Initialize ( CLSIDfi rStreamCLSID ); 
DWORD Attach( CLSIDfi rStreamCLSID ); 
DWORD Detach ( void ) ; 

// Actions 

DWORD SetStreamInfo( LPXMCSTREAMINFO pSI ); 
DWORD GetStreamlnfoC LPXMCSTREAMINFO pSI ); 
DWORD GetCLSID ( LPCLSID pDriverCLSID ); 
DWORD GetHandle ( LPXMC_H STREAM phStream ) ; 

private: 

// Private Data 



LPXMCSTREAMINIT mjDStreamlnit ; 

LPXMCSTREAM m_pStream; 



); 
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5.4.5 CDriverlnfoMap Class 

The CDriverlnfoMap class describes the current state of the driver administrator component 
regarding installed drivers and streams. The driver administrator CPL queries the driver 
administrator component for this block of information, that it then uses to update the user- interface 
describing the drivers and streams installed. 

class CDriverlnfoMap 

{ • • 

public: 

// Constructors & Destructors 

CDriverlnfoMap ( void ); 
-CDriverlnf oMap { void ) ; 

// Actions 

DWORD Load{ LPUNKNOWN *rgpDrvUn)c, DWORD dwDrvCount, 

LPUNKNOWN *rgpStrmUnk, DWORD dwStrmCount ) ; 

// Public Data 



LPXMCDRIVERINFO m_rgDriverInf o [ ] ; 
DWORD m cbDriverlnfo; 



}; 



5.5 Registration Database Data 

The driver administrator manages all drivers registered in the XMC system and stores a persistent 
list of information, describing each, in the registration database. Below, is the definition of the 
format used to store the driver information in the registry. 

XMC. Driver Administrator. 100 

I Drivers * 

I Enabled 

I | nCount - 1 

, | (CLSID) - "AT64 00" 

I 

I Disabled 

| nCount - 2 

| {CLSID} - "DMC1000" 

| {CLSID} - "DT2000" 
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